APPROVED 
s BY 

V- 

DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 




16 



18- 



18 



FIG. 1 




ATM 



TELLER 
STATION 




TELLER 
STATION 



12 



LAN 

I 



14 



12 



12 



12 




22 



SERVER 



WAN 



24 



BACK 
OFFICE 




BACK 
OFFICE 



BACK 
OFFICE 



20 



■20 



20 



10 



49- 



48 



46 



2l 



r 



16 



SERVICE TERMINAL 



40 



AGENT 
HANDLER 



CPU 



42 



J 



FIG. 2 



I 



32 



I/O 



45 



44a 



44b 



44c 



44d 



£ 



14 



< 



I 



50 



APPROVED 
\ 
BY 

DRAFTSMAN 


O.G. FIG- 


class 


SUBCLASS 



• 



FIG. 3 



■50 



52^ 




54 






^56 


^58 




ADDRESS LISTS 






HEADER/SOURCE 
ADDRESS 


54a 


54b 




54n 


CODE/DATA 


REGISTER 


o 








f 2Z 





14 



< 



50a 



7 



FIG. 4 



SERVER 



^132 
I /O \ - 



140 



AGENT 
HANDLER 



CPU 



170 



1 



IP ADDRESS 
LIST 



142 



172 



MONITOR 



r 



174 



SERVER 
FUNCTION 



FIG. 5 



180 



RECEIVE AGENT | 



i 



182 



CHECK SECURITY | 



I 



r 



184 



UPDATE SERVICE REGISTER 



\ ^1 86 
EXECUTE AGENT PROGRAM] 



I 



^-1 88 
FORWARD AGENT | 



approved 
bV - 

draftsman 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 6a 

50a ^ 50a 



ATM 1 



<=b LAN 



16a 



40 



12 



ATM 2 



16b 



40 



ATM 3 



16c 



40 



12 



18a 



TS1 



40 



18b 



TS2 



I 



14 



12 



SERVER 


172 


22 


140 



WAN 

T 



24 



B0 1 20a 



BO 2 20b 



12 



BO 3 20c 



40 



12 



•10 



APPROVED 
DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 6b 



t 

16a 


VTM1 


40 




16b 


MM 2 


40 




16c 


MM 3 


40 




18a T S1 




40 




18b TS2 




40 



50a 



— i-/ 

i . 



12 



•50a 



12 



LAN 



12 



SERVER 


172 


22 


140 



WAN 

T 



24 



B0 1 20a 



BO 2 20b 



12 



BO 3 20c 



•12 



10 





APPROVED 


O.G. FIG. 




BY 


CLASS 


SUBCLASS 




DRAFTSMAN 







16a 


VTM1 


40 




16b 


MM 2 


40 




16c 


MM 3 


40 




18a TS1 




40, 


5 



FIG. 6c 

LAN 



12 



12 



18b 



TS2 



50a 



I 



14 



40 



12 



12 



SERVER 


172 


22 


140 



12 



WAN 



t: 



24 



B0 1 20a 



BO 2 20b 



BO 3 20c 



■10 





APPROVED 


O.G. FIG. 




BY 


CLASS 


SUBCLASS 




DRAFTSMAN 







FIG. 7 



r 



190 



RECEIVE RETURNING AGENT 



I 



r 



192 



CHECK SECURITY TO ENSURE 
RETURNING AGENT 



I 



r 



194 



EXAMINE INFORMATION 



14 



50b 



7 



FIG. 9 



20 



MAINTENANCE TERMINAL 
232 ^-240 



I/O | 



AGENT 
HANDLER 



CPU 



250 



1 



ERROR 
LOG 



242 



170 



I 



238 



MAINTAINER 
MONITOR 



APPROVED 
BV 1 
DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 8a 



ATM 1 



16a 



40 



50b 



12 



ATM 2 



16b 



40 



ATM 3 



16c 



40 



12 



18a 



TS1 



40 



18b TS2 






40 


^12 



LAN 



I 



14 



12 



SERVER 


172 


22 


140 



WAN 



r 



B01 20a 



240 



50b 



BO 2 20b 



240 



12 



BO 3 20c 



240 



■10 



APPROVED 
BY 


D G FIG 


CLASS 


SUBCLASS 



FIG. 8b 



ATM 1 



16a 



40 



ATM 2 



16b 



40 



ATM 3 



16c 



40 



50b 



12 



50b 



12 



18a 


TS1 




40 



18b 


TS2 




40 



12 



LAN 



14 



12 



SERVER 


172 


22 


140 



12 



WAN 

T 



24 



B0 1 20a 



240 



BO 2 20b 



240 



BO 3 20c 



240 



-10 



APPROVED 

BY * 
DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 8c 



18b 



TS2 



■50b 



16a 


VTM1 


40 




i 

16b 


\TM 2 


40 




16c 


MM 3 


40 




18a TS1 




40 





<F=> lan </---: 



12 



12 



I 



14 



50b 



12 



SERVER 


172 


22 


140 



12 



WAN 



24 



B0 1 20a 



240 



BO 2 20b 
~240 



BO 3 20c 
~240 



40 



12 



■10 



APPROVED 
BY 

DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 10 



ATM 1 



16a 



40 



ATM 2 



16b 



40 



12 



50c 



ATM 3 



16c 



40 



12 



18a 



TS1 



40 



18b 


TS2 




40 



•12 



LAN 



12 



SERVER 


172 


22 


140 



•50c 



12 



WAN 

T 



B0 1 20a 



240 



BO 2 20b 



240 



BO 3 20c 



240 



•10 



24 



APPROVED 
BY 

DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 11a 



330 



WAN 

r 



r 



22 



50a 



50a 



7 



5 



SERVER 


172 




140 



•50a 



50a 



■320 



r 



16 



ATM 




48 




40 






-310 


LAN 





^3 00 

PoS TERMINAL 
238 I 



APPROVED 
BY 

DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. lib 



330 



1 



WAN 



50b 



22 



50b 



50b 



7 



SERVER 


172 




140 



50b 



50b J 



■320 



16 



ATM 




48 




40 




O IU 


LAN 






r 



300 



PoS TERMINAL 


238 




48 


240 



APPROVED 


O.G. FIG. 


BY 


CLASS 


SUBCLASS 


DRAFTSMAN 







50c 



16 



FIG. 11c 



330 



WAN 



50c 



I 



£_ 



22 



SERVER 


172 




140 



< 



50c ^ 



50c 



320 



ATM 




48 




40 




-310 


LAN 






r 



300 



50c 



7 





PoS TERMINAL 


I" 1 


238 




> 


48 


240 



APPROVED 
BY 

DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



SOH Monitor 



MonitorServer MonitorClient WebMain 

PJQ. J 2 Webserver ObjectMain 

ObjectClient ObjectServer 



public class ModuleDetails implements Serializable 
{ 

/** Modules port number */ 
int PortNumber; 

/** Modules name */ __. _ 

String ModuleName; rl.Cj« X3 

I** Modules IP address 7 
String IPAddress; 



r Modules State of Health */ 
String SOH; 



APPROVED 

BY ' 
DRAFTSMAN 


O.G. FIG. 


CLASS 


SUBCLASS 



FIG. 14 



State of Health Monitor 



ATM's Monitored: 



Monitoring Frequency: 



Start 



153.73.152.191 \\± 



Stop | 



FIG. 15 



Peer to Peer Messaging 



Module Application 



SoH Interfaces 



Message 


Message 


Receive 


Transmit 


Thread 


Thread 


Message 


Queues 



Network Layer 



Host l/F 
(TopEnd) 



Module 
Application 



User 
l/F 



Logs, Tallies, 
SoH 



Hardware 
Interface 



Hardware 




Server 
Socket 
Thread 



Agent 
Server 
Thread 



Agent 
Handler 



Embedded 
Server 



APPROVED 


O G FIG ! 


j BY 


CLASS 


SUBCLASS : 

: 






: 



FIG. 16 

public void Searching(String temp) 
{ 

if (temp.equalslgnoreCase("SHTR JAM")) 
{ 

Log[0] = Log[0] +1 ; // Incrementing the log if a match is found 
if (Log[0] >= 0) //Threshold = 0 

error.setErrorArray(0, "Shutter Jam"); // If the threshold is broken 

then 

//set array locationO to 
'Shutter Jam' 

} 

// Calls the function that will send the Error Array to the Regional 
// Server and generate and Alert Agent if the error is fatal 
send(); 
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/** Determines whether or not to send out a Alert Agent */ 
public void processReturningAgent() 
{ 

int count =0; 

Vector ATMsToVisit = new Vector(1 ,1); 
AlertAgent aAgent; 

ATMsToVisit = mAgent.getATM(); 
int size = ATMsToVisit.size(); 

while (count < size) // Extracts the records one at a time and examines the State of Health 
{ 

ModuleDetails Mtemp = (ModuleDetails)ATMsToVisit.elementAt(count); 
String tempSOH = Mtemp.getSOH(); // Gets the modules state of Health 

if (tempSOH.equals("Healthy")) 
{ 
} 

else 

// Create an alert agent and initialise it with the Replenisher Location Details. 
{ 

agent = new AlertAgen^RepIP, RepPort,Mtemp); 

// Get the Internet address and the port number 

// of the first Replenisher String nextAddress = ReplP[0]; 

int nextPort = RepPort[0]; 

// Send out the Alert Agent 

MonitorClient client = new MonitorClient(nextAddress,nextPort,aAgent); 
} 

count++; 
} 

} 
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public void StoreData() 
{ 

int count =0; 
boolean flag = false; 

String temp = sAgent.getReplenisherslP(); 

while(ReplP[count] != null) // Finds the next free space to add the Replenisher data to 
{ 

count++; 
} 

RepPort[count] = sAgent.getReplenishersPort(); // Adds the new data to the arrays 
ReplP[count] = sAgent.getReplenisherslP(); 

sAgent.SendOutServiceAgent(); // Passes the service agent onto the next module 
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public void processServicerslnfo(RepDetails rep, String IP, int port) 
{ 

DisplayError dError; 
AlertAgent agent; 

RepDetails details = new RepDetails(); 

details = rep; // A local copy of the class RepDetails, this stores all the Replenishers 



int count =0; 
int counter =0; 
CurrentIP = IP; 
CurrentPort = port; 

String tempLocation = details.getl_ocation(); // Gets the Replenishers location 

String tempStatus = details.getStatus(); // Gets the Replenishers status 

StringQ tempService = details.getServicesQ; // Gets the list of what the Replenisher can 



if (tempLocation.equalslgnoreCase(LookForLocation)) 
{ 

if (tempStatus.equalslgnoreCase(LookForStatus)) 
{ 

if (tempServicetOl.equalslgnoreCaseC'Dispenser")) 

dError = new DisplayError(ErrorlP, ErrorModule, ErrorSOH,this); 
} 

else if (tempService[1].equalslgnoreCase("Card Reader")) 
{ 

dError = new DisplayError(ErrorlP, ErrorModule, ErrorSOH,this); 
} 

else if (tempService[2].equalslgnoreCase( ,, Printer ,, )) 
{ 

dError = new DisplayError(ErrorlP, ErrorModule, ErrorSOH,this); 
} 

if (tempStatus.equalslgnoreCase("Primary")) 
LookForStatus = "Secondary"; 

if (tempStatus.equalslgnoreCase("Secondary")) 
LookForStatus = "Final"; 
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if (tempStatus.equalslgnoreCase("Final")) 
{ 

LookForStatus = "Primary"; 

if (tempLocation.equalslgnoreCase("Local")) 

{ 

LookForLocation = "Remote"; 
} 

} 

NumberOfServicers++; 
} 

else 
{ 

int size = 0; 

while (IPList[size] != null) // Gets the number of Replenishes in the list 
{ 

size++; 
} 

if (NumberOfServicers == size) // When all the Replenishers have been visited, go 
back 

{ 

int nextport = PortList[0]; // Set to the starting port number 
String nextIP = IPList[0]; // Set to the starting IP number 
String signal = "Alert Agent"; 

Client client = new Client(nextlP, nextport, signal.this); // Send out the agent 
} 

else 

while (IPList[counter] != CurrentIP) // Find the array position of the Replenisher 
{ 

counter++; 
} 

if (IPList[counter].equalslgnoreCase(CurrentlP)) 

int nextport = PortList[counter++]; // Move on to the next Replenisher if 
String nextIP = IPList[counter++]; // nothing suitable here 
String signal = "Alert Agent"; 

Client client = new Client(nextlP, nextport, signal.this); 
} 

} 

NumberOfServicers++; 



} 



APPROVED 
BY * 



4 



■j DRAF TSMAN 



O.G. FIG. 



CLASS SUBCLASS 



FIG. 25 



Assistance Request 



ATM Name: 



Module Name: 



153.73.152.191 



Card Reader 



State of Health: INSPECT NOW 



Will you be able to attend to the problem ? 



I Y°s I [ 



No 



Action Details 



Start up the Web Browser to find out more about the problem... 
The information can be found on: 
https://www.tdserver.https.test.html 



Yes 



FIG. 26 



ATM MODULE 



WEB 
SERVER 



AGENT 
SERVER 



TALLYS 



TCP/IP 



FIG. 27 



SERVER 



WAN 



WEB 
PAGE 



APPROVED 
* 


O.G. FIG. 


BY 


CLASS 


SUBCLASS 


DRAFTSMAN 







FIG. 28 

If (temp.equalslgnoreCase("Shutter Jam")) 
{ 

Description[count] = "The shutter has jammed " + "open or closed. This " + 

" was detected when a card was" + "being accepted or ejected"; 

Check[count] = "Shutter, Card Reader"; 
StateOfHealth = "INSPECT NOW"; 
} 



FIG. 29 



Available 



u 



FIG. 30 

192.23.234.195 



cfb Fix 
Li ATM 



FIG. 31 



public void runServer() 
{ 

int sPort = 6050; // initialises this value to 6050 
ServerSocket Serv; 



try 



{ 

// Set the socket to be monitored 
Serv = new ServerSocket(sPort); 



FIG. 32 



// if the thread does not link to anything then create one and start it running 
if (runner == null) 
{ 

// run the ServerThread as a new thread 
runner = new AppletServer(Serv,this); 



} 



// start the thread runner running 

runner.start(); 

} 



catch (Exception e) 
{} 

} 
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public void run() 
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Object temp = null; 
String tempString = null; 

while (true) 
{ 

try 

{ 

// waits on the server until a message is received 
Socket server = Serv.accept(); 

// creates a new stream to connect to and bind 

ObjectlnputStream in = new ObjectlnputStream(server.getlnputStream()); 

// reads in the object and changes it too a String 
temp = in.readObject(); 
tempString = temp.toString(); 

if (tempString. equalslgnoreCase("Service Agent")) 
{ 

SAgentPresent = true; 

// Reads in the service agent 
sAgent= (ServiceAgent)in.readObject(); 
} 

} 

catch (Exception e) 
{ 

System.out.println(e); 
} 

} 
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public void SendAgentQ 



{ 



// Set Output To Send Agent To First Server 
try 

{ 

// try and connect to Socket destName.destPort 
Socket s = new Socket(destName, destPort); 

// create an ObjectOutputStream (out) 

ObjectOutputStream out = new ObjectOutputStreann(s.getOutputStream()); 

// Got a connection Send Agent To Server 

// Sends out the corresponding agent 

if (state.equalslgnoreCase("Service Agent")) 

{ 

out.writeObject(state); 
out.writeObject(sAgent); 

} 



// Close outgoing port 

s.close(); 

out.close(); 

} 

catch (Exception e) 
{ 
} 
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Description 


SoH 


AppletCenter.java 


Handles all the displaying and passing of data to the 
Applet. It controls what images etc. are displayed and 
when they are displayed. 




AppletMain.java 


Used to check that the thread is not already running 
and that the server can start running. Also used to 
pass data between the AppletCenter class and the 
AppletServer class. 




AppletServer.java 


Listens on a specified server connection and waits 
for incoming messages. It listens for messages from 
the Regional Server. Once a message has arrived it 
takes the corresponding actions. 




ControlPanel.java 


Holds navigation buttons and a Break button that is 
used onlv for demonstration Dumoses 

uww\j winy i vi u vi i ivi ivii (pA uvj i i uui uv/uvui 




Frrorc Fixed iava 


Di^nlav^ thp Fiv Frror^ ^rrppn anri all thp dptaita 

L/IOUIuyO U IC 1 IA UllulO Owl wOl 1 Gil l\J GUI 11 Iv VJwlClllO 

about an error. Any of the errors can be fixed by 
selecting one and pressing the OK button. This 
causes the ATM to reset itself and the error to be 
removed from the error records. 




FixMoney.java 


Help screen on how to fill the ATM with money. 




Ink.java 


Help screen on how to replace ribbon. 




Paper.java 


Help screen on how to fill the ATM with paper. 




Knife.java 


Help screen on how to replace the knife. 




PurneBin iava 


HpId screen on how to emDtv the Duroe bin 

1 IvIU Owl W W 1 1 w 1 1 1 IWt IV wl 1 1 I y 11 lw L/UIUW wlil> 




Record.java 


Stores all the details about one error. An array of 
these is used to pass error data between the various 
classes and store all current error information. 




ScreenO.java 


Displays the components of the main screen on the 
Applet. 




Screenl .java 


Displays the components of the Replenishers screen 
on the Applet. 




Screen2.java 


Displays the components of the Field Engineers 
screen on the Applet. 
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Class Name 


Description 


Regional 


Agent.java 


Class that is inherited by all the various agents. 




AienAgeni.java 


Agent inai is produced wnen an error occurs ana 
takes this data to the Replenisher to ask for help. 




Confirm Mess, java 


Class that displays the whereabouts of the Applet. 




DisplayError.java 


Class that displays the components of the error and 
ask the Replenisher for help. 




ModuleDetails.java 


Stores the individual details of an ATM module. This 
information is vital in the movement of the agents 
around the network. 




MonitorAgent.java 


Agent that is used to constantly monitor the State of 
Health of all the ATM modules. It has also the 
intelligent to move around the network. 




MonitorClient.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. This class has 
the ability to send out all the different agents. 




MonitorServer.java 


Listens on a specified server connection and waits 
for incoming messages. It listens for Service Agents, 
Returning Monitor Agents and ATM modules 
registering. Once a message has arrived it takes the 
corresponding actions. 




SOH_Monitor.java 


Main class for this package. Used to handle all the 
incoming data and execute the calls that will send 
out the Monitor Agents. 




ObjectClient.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. It is responsible 
for sending requests to an ATM module Webserver. 
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Class Name 


Description 


Regional - 
Cont'd 


ObjectServer.java 


Listens on a specified server connection and waits 
-for incoming messages. Listens for messages and 
reset acknowledgements from the Embedded 
Webservers. Once a message has arrived it takes 
the corresponding actions. 




ObjectMain.java 


Used to check that the thread is not already running 
and that the server can start runnina 




ServiceAgent.java 


Agent that will take the Replenishers Internet address 
and agent handler port number to the Regional 
Server and all of the reaistered ATM modules 




StringProcessor.java 


Adds additional information to be sent out along with 
the error data to the AoDlet 




WaitAWhile.java 


This is a thread that is used to sleep if an ATM has 
not registered and a Replenisher has logged in. 




WebClient.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. Can send out 
serial data streams to the AppletServer. 




WebMain.java 


Used to check that the thread is not already running 
and that the server an start running. 




WebServer.java 


Listens on a specified server connection and waits 
for incoming messages. Listens for serial data 
coming from the AppletCenter. Once a message . 
has arrived it takes the corresponding actions. 



APPROVED 
• 




i ^ 


m a*^ 

w 1 — MOO 




DRAFTSMAN 




j 



FIG. 35d 



Functional 
Block 


Class Name 


Description 


Replenisher 


Client.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. Sends out 
the Service Agent and the Alert Agents when 
desired. 




Server.java 


Listens on a specified server connection and waits 
for incoming messages. Listens for Alert Agents 
coming to check out the Replenishers details. 
Once a message has arrived it takes the 
corresponding actions. 




RepDetails.java 


Used to store the details a Replenisher has added 
to the details screen when they logged in. 




DetailsScreen.java 


Main class for this package. Used to take the 
information from the screen and store it in 
RepDetails. It will also start-up the server and call 
the Client class to send out the Service Agents. 
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Agent 


AgentHandler.java 


Used to check that the thread is not already 
running and that the server an start running. 




AgentServer.java 


Listens on a specified server connection and 
waits for incoming messages. Listens for 
incoming Service and Monitor Agents. Once a 
message has arrived it takes the corresponding 
actions. 




AgentClient.java 


This class has the ability to bind to ports on 
certain terminals and send out data for them. 
Sends out Alert and Monitor Agents. 
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Class Name 


Description 


Webserver 


Client.java 


This class has the ability to bind to ports on 
certain terminals and send out data for them. 
Sends out all the data that is required to display 
information on the Applet. 




Server.java 


Listens on a specified server connection and 
waits for incoming messages. Listens for 
requests from the Applet that are passed on 
by the Regional Server. Once a message has 
arrivpri it takp<5 thp rorrp^nonrlinri artinn*; 




WebServer.java 


Main class for this package, used to set-up and 
start the server. 




ErrorList.java 


Class that holds the array of errors that have 
been produced and location details about were 
the errors occurred. 




ResetDetails.java 


Class used to reset details in order to set a tally 
back to zero. 
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Description 


Tallies 


Tallys.java 


Inherited by all the classes below. Used in the 
Regional Server to access their functions and get 
the necessary information. 




CardTallys.java 


Holds the tally mnemonics that are unique to the 
Card Reader class and the procedures that are 
needed to process them. 




DispenserTallys.java 


Holds the tally mnemonics that are unique to 
the Cash Dispenser class and the procedures 
that are needed to process them. 




PrinterTallys.java 


Holds the tally mnemonics that are unique to the 
Receipt Printer class and the procedures that 
are needed to process them. 




ProcesslPs.java 


Used to get the modules Internet address and 
process it. 
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